Voxel grid ASCII file format

OBJECT VOXELGRID Name

[CRS Authority Code Name HorizontalUnit]

[CSYSTEM Easting Northing TVDSS Inclination Azimuth]

[UNITS EastingUnit NorthingUnit VerticalUnit InclinationUnit AzimuthUnit]

[COLOR Red Green Blue [Alpha]]

[UNKNOWN UnknownValue]

DIMENSIONS NumberNorth NumberEast NumberDepth StepNorth StepEast StepDepth

STEPDIMENSIONS NorthStartIndex NorthStepSize EastStartIndex EastStepSize

CONSTANT ConstantValue |

[VALUES ValueSpecificationType]

PropertyValue(0) .....

.....

..... PropertyValue(NumberNorth*NumberEast*NumberDepth-1)

Keywords (the order of these keywords does not matter, except from the OBJECT keyword – this keyword should always be the first one – and that the Property values are always at the end).

Keyword	Description	Optional	Comment
VOXELGRID	Specifies the object type	No	One value is expected: 1. Name of the voxelgrid
DIMENSIONS	Specifies the voxelgrid dimensions	No	Six values are expected: 1. Number of cells in Easting direction 2. Number of cells in Northing direction 3. Number of cells in Depth direction 4. Cell size in Easting direction 5. Cell size in Northing direction 6. Cell size in Depth direction
CONSTANT	Specifies a constant property value	Yes	One value is expected: 1. The constant property value When this keyword is not found, a series of property values is expected
VALUES	Specifies the way the property values are ordered	Yes	One value is expected: 1. Specification type (Default = DSTART_NSTART_ESTART) When this keyword is not included, the default type is applied

Variables

Variable	Description	Type	Min	Max	Optional	Comment
NumberNorth	Number of cells in northing direction	int	1	>=1	No	Minimum 1 cell
NumberEast	Number of cells in easting direction	int	1	>=1	No	Minimum 1 cell
NumberDepth	Number of cells in depth direction	int	1	>=1	No	Minimum 1 cell
StepNorth	Cell size in northing direction	double	>0	>0	No	Size should be bigger than 0
StepEast	Cell size in easting direction	double	>0	>0	No	Size should be bigger than 0
StepDepth	Cell size in depth direction	double	>0	>0	No	Size should be bigger than 0
ConstantValue	Values to be used as constant depth	double	-	-	Yes	Default = 0.0
ValueSpecificationType	Specifies the way the values are ordered	int	0	1	Yes	0 = NSTART_ESTART_DSTART 1 = ESTART_NSTART_DSTART
PropertyValue(index)	Property value at a cell center	double	-	-	No	Property values are ordered in north direction first by default, then east, then depth

Example 1

OBJECT VOXELGRID VoxelGrid1

CRS EPSG 32065 "NAD27 / BLM 15N (ftUS)" ftUS

CSYSTEM 569000 168000 1600.0 0.0 0.0

UNITS m m m deg deg

COLOR 128 234 98 1.0

UNKNOWN -1.0E10

DIMENSIONS 11 9 11 400 370 80

9 -10 -5 -25 4 18 6 22 -13 2 7 16 -3 -12 -7 27 22 4 5 -9 -4 -5 8 -7 -5 12 7 -8 8 -5 4 -10 -2 7 -8 -16 10 21 -16 4 10 0 -1 -1

1 15 -3 -34 27 -1

-5 -12 -7 -6 -4 -2 -1 12 -24 19 -18 -24 -7 -17 -7 -2 -5 -6 1 -7 -1 1 26 -8 12 1 -2 -7 -22 6 10 -14 -1 15 -22 -27 15 1 8 -13

16 -4 -5 -8 53 -40 40 -4 1 -2

-10 0 -7 -6 8 32 -29 -3 0 11 0 0 -11 -22 5 -3 -3 2 -13 5 10 11 -7 -7 -13 10 -8 12 13 -1 6 1 3 -16 -10 0 7 -3 29 21 13 2 -3 -

6 -19 25 24 -8 -5 17

19 10 -25 7 -4 -19 2 14 -2 -7 9 15 -46 17 8 20 -2 -22 -2 26 -15 7 23 -9 -17 1 13 5 5 -25 29 -7 48 7 54 1 -5 -8 5 21 -4 2 6

32 -16 -16 4 -5 -9 -19

20 23 -12 -14 3 21 -38 9 17 -2 -15 36 7 5 -23 0 3 -35 7 7 5 7 12 -2 9 -9 -23 3 -23 0 5 4 7 8 -3 20 -6 -24 -7 -28 4 0 5 -7 -

34 -19 12 -2 2 19

-21 10 -1 -11 -8 -14 -21 -12 26 -17 16 -29 22 -22 -12 -2 27 -2 -13 12 22 -11 17 23 18 0 -28 5 23 -6 -24 21 -9 -7 18 -10 11 0

-34 12 37 -24 18 -15 33 -6 -5 7 7 -22

1 27 -2 5 -15 7 3 -15 -3 5 17 -7 6 9 23 -26 -13 7 -3 7 0 -4 -12 23 -17 -16 2 -10 -9 11 8 -16 -3 26 0 -30 -2 28 -18 -8 0 -1

12 13 -3 17 -16 -30 -4 -11

7 10 9 2 10 -5 29 0 -2 -16 -14 -2 2 -5 -4 -2 0 13 -2 11 11 5 15 12 -14 1 10 -24 -27 32 8 2 -21 33 8 -11 -3 17 -16 -33 42 13

-23 -2 8 -2 8 -2 1 -14

15 -19 1 -6 8 6 -3 -5 -17 13 13 19 -29 -7 -6 -10 -3 -1 -5 -25 4 39 -15 -33 -3 -35 -6 1 -7 4 -2 22 9 11 -11 7 -45 9 7 4 -3 9

13 -39 36 -21 -19 5 -11 -3

6 -2 -4 25 14 -21 11 37 -21 0 -7 1 -6 38 17 -3 -25 -1 33 -9 8 -2 -4 0 48 4 -9 -7 -3 14 -14 -13 4 -4 -9 19 17 3 -4 -22 6 -28

15 -1 -13 -7 22 -39 3 8

-2 -4 25 14 -21 11 37 -21 0 -7 1 -6 38 127 -3 -25 -1 33 -9 8 -2 -4 0 48 4 -9 -7 -3 14 -14 -13 4 -4 -9 19 17 3 -4 -22 6 -28

15 -1 -13 -7 22 -39 3 8 -3

-4 -14 17 7 -13 3 23 -23 -6 32 8 11 8 4 -1 -14 6 48 -80 18 22 23 3 16 1 -7 -12 7 53 -40 16 9 8 -38 28 1 -5 0 3 20 -48 45 -23

-46 -42 7 1 -23 18 -1

-1 9 13 -20 -10 -29 8 -6 -1 -1 17 6 -37 34 -16 -23 -6 1 3 -13 5 -12 -13 18 21 -20 10 49 -37 0 6 -8 0 -2 -10 -9 -9 16 14 -5 -

1 11 -5 1 -9 0 9 14 -6 10

1 -13 -12 9 9 36 16 2 1 -16 -9 -27 4 -11 5 13 20 -48 45 14 -39 -10 -6 9 -18 2 -8 7 31 0 9 9 12 -9 0 -7 -8 -13 17 21 -17 -8

31 0 -27 -17 15 -3 -2 16

33 -21 -4 26 -15 12 -11 6 12 19 -1 -22 12 -14 -35 -24 19 -6 2 17 -1 -11 9 12 -37 -19 -25 2 -14 -2 -1 13 17 -47 24 -37 -33 2

1 1 -3 -7 5 -18 2 12 -24 -1 40 -38

-2 7 -4 -1 -5 -19 -1 -9 6 24 -33 -12 3 -8 4 -5 -2 3 7 -18 0 7 -5 14 13 12 22 14 -13 2 -28 12 7 1 -2 3 25 1 -74 36 -11 2 -1 3

1 -11 20 0 7 19

13 -3 4 34 18 -25 -4 9 1 3 44 -13 -5 2 -4 20 -18 -2 10 8 1 17 -41 24 14 -16 55 -8 -3 12 2 -8 5 -44 20 -13 -30 23 1 -1 10 -13

-29 1 -22 -36 -11 -13 4 -10

0 2 -9 17 -13 -17 -7 3 30 -14 29 5 -2 -8 -18 17 10 12 29 38 -26 -9 4 -8 -4 -16 -10 -1 -14 -4 31 -35 9 3 -12 4 -14 -4 3 7 1

20 -24 16 -10 -1 0 -16 1 -3

-5 5 13 8 -15 15 -4 7 19 -127 39 37 -4 3 8 12 -12 2 3 -11 -42 0 10 -20 6 15 18 -4 8 0 -6 1 -62 11 14 1 -11 17 -8 22 -17 0 17

-5 -35 10 -10 5 -31 -13

17 -5 -3 26 -7 -45 -13 7 -14 -4 2 12 -3 -6 23 -12 19 20 20 -9 0 5 13 -26 -5 19 -24 5 -15 8 -1 -14 23 21 -11 -16 33 1 13 -1 7

-6 -11 8 -14 0 6 -2 2 -19

7 14 -29 30 -19 -4 -4 -11 13 0 25 -1 0 -7 -4 -3 -4 -3 14 -14 11 1 16 -9 2 3 16 -10 7 32 -44 28 6 -5 3 4 6 1 -13 -6 4 7 -48

20 -6 22 -1 22 -11 -4

26 -21 5 13 14 -13 -17 4 13 1 4 25 -36 -14 3 -4 -5 5 14 3 14 -4 17 -32 9 1 0 1 2 3 -19 16 4 -4 9 13 6 54 34

Example 2 (minimum / all optional fields left out – using values series)

OBJECT VOXELGRID VoxelGrid2

DIMENSIONS 3 4 3 600 500 250

-127 -127 -127 -100 -100 -100

-75 -75 -75 -50 -50 -50

-25 -25 -25 0 0 0

25 25 25 50 50 50

75 75 75 100 100 100

110 110 110 127 127 127

Example 3 (minimum / all optional fields left out – using constant value)

OBJECT VOXELGRID VoxelGrid3

DIMENSIONS 50 40 100 40 50 5

CONSTANT 127